home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / program / 114 / ezscreen / print_me.doc < prev    next >
Text File  |  1987-10-10  |  15KB  |  331 lines
  1.  
  2.       EZ_SCREEN is SHAREWARE                                       - 1 -
  3.  
  4.  
  5.  
  6.                              EZ SCREEN FORMATTER
  7.  
  8.            The EZ SCREEN FORMATTER is a code generating  program.   This
  9.       means that you use it to actually write GFA BASIC program code for
  10.       simple  input/output.   You  use the program to  design  an  input
  11.       screen  of  80 columns by 24 lines,  using the  function  keys  to
  12.       designate how the program is to interpret your input.
  13.  
  14.            You create 'masks' of letter only,  numeric only or character
  15.       (both numeric and letters), forcing the program you will create to
  16.       screen your input.   The code that is generated can be either   an
  17.       entire GFA BASIC program or just a procedure to merge into another
  18.       program.  These programs and procedures are written out to disk in
  19.       ASCII form.
  20.  
  21.            You  will  have to MERGE it using the  GFA  interpreter,  but
  22.       these  programs  and procedures will only be a shell  for  you  to
  23.       start  building  your own application  from.   Please  read  these
  24.       instructions so that you can learn to fully utilize this code into
  25.       your own programs.
  26.  
  27.            You  the  programmer  create  a  mask  or  masks  of  inverse
  28.       characters  that  denote the length of the field  for  input,  and
  29.       allow  you  to  denote  which type of character  input  is  to  be
  30.       allowed.   Furthermore,  at  the same time,  you also  place  text
  31.       prompts onto the screen to guide your user.
  32.  
  33.            Also,  the program allows your user to jump around the screen
  34.       filling in whatever blank he would like next,  until such time  as
  35.       he signals he is finished inputting data by pressing the UNDO key.
  36.       The  EZ SCREEN FORMATTER will generate an ASCII file that  can  be
  37.       merged  into the GFA BASIC INTERPRETER,  and then RUN to test  the
  38.       design of your input screen.
  39.  
  40.            The program will display a file selector box, and you will be
  41.       prompted  for an INPUT FILE name.   If you do not yet have a  data
  42.       file,  or  whenever  you are creating a new  program,  select  the
  43.       CANCEL button,  this will provide you with a blank screen to edit.
  44.       If you have an existing .SCR file, select it.
  45.  
  46.            If  you  try  to  select a file that does  NOT  have  a  .SCR
  47.       extension, the program will add the .SCR extension anyway and then
  48.       try  to  find it.   After a couple of seconds,  the  program  will
  49.       display your previously defined screen (if you selected one,  or a
  50.       blank screen if you selected CANCEL) and then display five prompts
  51.       at the bottom of the screen.
  52.  
  53.            One  of the first four prompts will be displayed  in  inverse
  54.       text at any point in time to let you know what mode you are in.
  55.  
  56.         These modes are:
  57.  
  58.                 ALPHA-Letters A-Z,a-z, 0-9, - or .
  59.                 CHARacter-Letters A-Z,a-z, - or .
  60.                 NUMeric-numbers 0-9 or - or .
  61.                 TEXT-any printable ascii except ,
  62.  
  63.  
  64.  
  65.       copyright 1987 David Stambaugh  2239 Hawthorne Washington IL 61571
  66.  
  67.  
  68.       EZ_SCREEN is SHAREWARE                                       - 2 -
  69.  
  70.  
  71.            The  last  prompt is actually a reminder that  when  you  are
  72.       finished  designing your screen,  that you should press  CONTROL-C
  73.       when you wish to continue on.
  74.  
  75.            Note that you have all but the last row of the screen to  use
  76.       to design your input screen.   This row of the screen will be used
  77.       for prompting you as you use this program, and later for prompting
  78.       your  user in the program that you will  create.   When  the  TEXT
  79.       mode  is selected,  anything you type (printable ASCII  characters
  80.       that is) will be displayed on the screen in normal mode.       The
  81.       F6  key inserts a blank line where ever the cursor happens  to  be
  82.       located and move all lines below it down one line. The data on the
  83.       last  line is lost if there is any.   The F7 key DELETES the  line
  84.       the  cursor is currently resting on and moves all following  lines
  85.       up one position.
  86.  
  87.            The F8 key INSERTS A SPACE at the current cursor location and
  88.       moves all information on the same line after that position to  the
  89.       right one space.   Any character in the 80th column is lost.   The
  90.       F9  key DELETES a space at the current cursor location  and  moves
  91.       all  following  characters  on  the same  line  to  the  left  one
  92.       position.
  93.  
  94.            In  case you forget which function key does what,  the  first
  95.       four  function  key  definitions  are  displayed  continually   by
  96.       default,  and the definitions of F6 through F9 can be displayed by
  97.       pressing the HELP key.   You must press any other key to  continue
  98.       on  after displaying these four definitions and the  program  will
  99.       revert to TEXT mode after this display.
  100.  
  101.            If  you  select  any of the  three  INPUT  modes  (CHARACTER,
  102.       NUMERIC  or ALPHANUMERIC),  then when you type,  you will see  the
  103.       letters C,  N or A appear on the screen in INVERSE mode.   This is
  104.       the MASK that you are creating for user input.   Anything that you
  105.       type while in this mode is actually a blank space for your user to
  106.       type into when the program is generated.
  107.  
  108.            Please  note  that while you are in NUMERIC  mode,  you  must
  109.       press  NUMERIC keys to get anything to appear on the  screen.  The
  110.       same thing holds true for CHARACTER mode.   The ALPHANUMERIC  mode
  111.       will allow almost anything except a comma to be pressed.
  112.  
  113.            Also  note  that if you run together two different  types  of
  114.       input for example NUMERIC immediately followed by  CHARACTER,  the
  115.       program catches this and treats this as two distinct input fields.
  116.       Now that you know what you are doing,  go ahead and try your  hand
  117.       at designing a screen.
  118.  
  119.            When you are finished, press the CONTROL key and the C key at
  120.       the same time.  Another File Selector box will be displayed.  This
  121.       time  it  is  important that you save the  screen  that  you  have
  122.       designed!   Once again,  the program will force the .SCR extension
  123.       even if you name the file something else.
  124.  
  125.            Furthermore,  all further files created past this point  will
  126.       use the same base file name (the same character to the left of the
  127.       period  in the final file name extension).    If you  skip  saving
  128.       this screen, then you will not be able to modify the file that you
  129.  
  130.  
  131.       copyright 1987 David Stambaugh  2239 Hawthorne Washington IL 61571
  132.  
  133.  
  134.       EZ_SCREEN is SHAREWARE                                       - 3 -
  135.  
  136.  
  137.       have just created.
  138.  
  139.            The program is set up so that you can modify an existing file
  140.       if you decide at a later time that you wish to modify it.   You do
  141.       not  need this file to create a running program,  but if you  find
  142.       that  you have made a mistake and have not saved this  .SCR  file,
  143.       then you will have to start over when you try to fix your mistake.
  144.       Choose an appropriate file name and save the file.       
  145.  
  146.            After  the file has been saved,  the screen will  once  again
  147.       clear  and  the upper twelve lines of your input  screen  will  be
  148.       displayed.  One by one, you will be asked to supply variable names
  149.       for  the  variables that are to contain the user  input  for  each
  150.       mask.   You  will also be shown some information about  the  field
  151.       such as X and Y locations on the screen and field length.
  152.  
  153.            Do  not use GFA BASIC variable names as this will cause  your
  154.       program not to run.   The variables are all of STRING type so  you
  155.       must  not try to type the variables by using the $ or % since  the
  156.       program does this for you.
  157.  
  158.            After you supply the variable name,  the program will ask you
  159.       for  a HELP message to guide the program user in deciding  how  to
  160.       supply the data or what to supply.  Whatever you type here will be
  161.       shown on the last line of the screen (the 25th line that you could
  162.       not  use  when defining the screen) in inverse type  whenever  the
  163.       cursor is in this particular field.
  164.  
  165.         You are limited to 65 characters on this help field).  After you
  166.       supply  the HELP string,  the program switches the question  marks
  167.       into  asterisks to denote that you have finished with that  field.
  168.       When you have finished with the first twelve lines of your screen,
  169.       the program then redisplays the next twelve lines and goes through
  170.       the same procedure as for the first twelve lines.
  171.  
  172.            When  you finish answering questions for both screen  halves,
  173.       the program will display the variable names,  some pertinent  data
  174.       such as field type and length and then ask you if this is what you
  175.       wanted.   If you respond with anything other than Y or y, then the
  176.       program  will  return  you to the screen  design  portion  of  the
  177.       program  with  the screen displayed as you currently  have  it  in
  178.       memory.
  179.  
  180.            If you want to quit without generating a new program,  simply
  181.       depress  the CONTROL SHIFT ALTERNATE key sequence that  terminates
  182.       GFA BASIC programs.   If you respond Y or y then the program  will
  183.       save the variables and the HELP line text to a file with the  same
  184.       base file name as your screen file but with a .VAR extension.
  185.  
  186.            Next  you will be prompted to press the letter P if you  want
  187.       the program to print out a list of all of the variables and  their
  188.       lengths  that  you  have defined in the previous  portion  of  the
  189.       program.   Pressing any other key will skip the variable printout.
  190.       The  next  prompt  is for you to press the  same  SINGLE  keypress
  191.       combination  that  you  would  like your user  to  enter  when  he
  192.       finishes inputting data.
  193.  
  194.            This can be any of the function keys,  the HELP key, the HOME
  195.  
  196.  
  197.       copyright 1987 David Stambaugh  2239 Hawthorne Washington IL 61571
  198.  
  199.  
  200.       EZ_SCREEN is SHAREWARE                                       - 4 -
  201.  
  202.  
  203.       key or ANY keypress combination that you want.   Note that this is
  204.       the  ONLY  way  to  signify that the user  is  finished  with  the
  205.       program.   If  you create a main program module and then add  some
  206.       different  procedures  to  show  different  screens  all  made  by
  207.       EZ_SCREEN, you can have different terminators in each screen.
  208.  
  209.            Now  the  program will ask if you wish to  create  an  entire
  210.       PROGRAM  or  just the unique SUBROUTINES needed to  merge  into  a
  211.       program  created by EZ_SCREEN.   A little explanation is in  order
  212.       here.   Some  of  the  procedures used in  a  program  created  by
  213.       EZ_SCREEN  have no changes made to them regardless of  the  screen
  214.       that was defined.
  215.  
  216.            If  you  define two programs with EZ_SCREEN  and  then  merge
  217.       them,  you  will have several duplicate procedures in your  merged
  218.       program.   EZ_SCREEN  allows  you to avoid this by  only  creating
  219.       these procedures ONCE, in the PROGRAM option.  If you then merge a
  220.       PROCEDURE  generated  by  EZ_SCREEN,   it  will  not  contain  the
  221.       duplicate procedures.
  222.  
  223.            If  you have more questions on this,  create a  program  with
  224.       EZ_SCREEN  and list it to the printer.   Then using the same  .SCR
  225.       file,  create a PROCEDURE and then list it to the printer.  If you
  226.       compare the listings you will see what procedures are not  created
  227.       in a PROCEDURE.   To choose which you are creating,  press P for a
  228.       program or S for a subroutine.
  229.  
  230.            Now for the most complex concept in using EZ_SCREEN.   If you
  231.       want  to  create  three or four screens to use  all  in  the  same
  232.       program,  then  EZ_SCREEN has to make unique names for all of  the
  233.       procedures  that  it uses.   These procedures  are  only  slightly
  234.       different from screen to screen but they must have a unique names.
  235.  
  236.            The  way  that EZ_SCREEN accomplishes this is to ask  you  to
  237.       input an EXTENSION that it adds on to the procedure name.   As  an
  238.       example,  each of the PROCEDURES start life with a name of EZ.  If
  239.       you  input an extension of Accounts,  then the procedure would  be
  240.       renamed  Ez_accounts.   (You do not have to input  the  underscore
  241.       character after the Ez_screen, the program does that for you.)
  242.  
  243.            Once you have answered the extension question,  lean back and
  244.       watch  your drive busy light (unless you are running this  from  a
  245.       ram  disk).   It really doesn't take very long for the program  to
  246.       finish writing out your new code.   The program will then generate
  247.       an  entire  BASIC program listing for you in  the  directory  from
  248.       which you ran the EZ-SCREEN program called ????????.LST.
  249.  
  250.            The  ????????  denotes the base file name you input when  you
  251.       saved your screen (.SCR) file.   The program will tell you when it
  252.       has finished generating this listing.   Now all you have to do  is
  253.       enter  the GFA editor,  make sure that the editor is empty  (do  a
  254.       NEW)  and then MERGE the ????????.LST file that was just  created.
  255.       If  you generated a program,  hit SHIFT-F10 and run it to test  it
  256.       out.
  257.  
  258.            Even  if  you only want a PROCEDURE,  it is a  good  idea  to
  259.       create  a PROGRAM first,  test using the input screen and then  go
  260.       back and create the PROCEDURE.
  261.  
  262.  
  263.       copyright 1987 David Stambaugh  2239 Hawthorne Washington IL 61571
  264.  
  265.  
  266.       EZ_SCREEN is SHAREWARE                                       - 5 -
  267.  
  268.  
  269.  
  270.            Note  that this program will only be a shell from  which  you
  271.       build the remainder of your application!
  272.  
  273.            The  code  is not very useful as it is generated by  the  EZ-
  274.       SCREEN  program,  but  is set up so that is would be easy  to  add
  275.       modules to turn it into a fairly professional looking  application
  276.       program.
  277.  
  278.            EZ_SCREEN is NOT PUBLIC DOMAIN SOFTWARE, it is SHAREWARE.
  279.               Please respect the author's right to make a buck.
  280.  
  281.            This program is SHAREWARE.   Use it free of charge to  decide
  282.       if you think it is worth paying to use.  If you wish to distribute
  283.       programs  written  wholly  or in part  by  EZ_SCREEN,  you  should
  284.       register  with  the  author  of  EZ_SCREEN  by  filling  out   the
  285.       registration  form (REGISTER.DOC) and sending it and $5.00 to  the
  286.       author at the following address:
  287.  
  288.                              Dave Stambaugh
  289.                              2239 Hawthorne Place
  290.                              Washington, IL 61571
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.       copyright 1987 David Stambaugh  2239 Hawthorne Washington IL 61571
  330.  
  331.